home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 031-040 / amok39 / rdt / rdt.doc < prev    next >
Text File  |  1993-11-04  |  6KB  |  189 lines
  1. Program:
  2. ========
  3.  
  4. RDT - Replace Default Tool            V0.3              4 March 1990
  5.  
  6.  
  7.  
  8. Program purpose:
  9. ================
  10.   To change, set and delete the Default-Tools in the Project-Icons!
  11.  
  12.   It should be an easy to use and efficient tool for people, who often have
  13.   to change the default toolname in the .info file.
  14.  
  15.  
  16. Author:
  17. =======
  18.   (C) by
  19.   Reinhard Geisler                    KAKTUS@TREFF.ZER     Zerberus-Net
  20.   Plockhorstweg 20
  21.   D-4178 Kevelaer 3                   KAKTUS;HCB           AmNet
  22.   Federal Republic of Germany
  23.  
  24.  
  25. Copyright:
  26. ==========
  27.   Authorized:
  28.     The use for private people and private purposes on their own risk.
  29.  
  30.     To copy the program und to pass on the copies, as long you don't
  31.     charge more than 5,- US Dollars (Germany: 5,- DM) including the
  32.     disk and as long you pass on the following files with it:
  33.        RDT
  34.        RDT.info
  35.        RDT.dok
  36.        RDT.doc
  37.        RDT.mod
  38.     It is authorized to put them all together in an archive!
  39.     For transfer through modem you can disregard the source-code (RDT.mod)
  40.     and the german documentation (RDT.dok), but in no way this documen-
  41.     tation (RDT.doc).
  42.  
  43.     The use of the source-code for all non-commercial people, as long you
  44.     leave my name in it.
  45.  
  46.     This program can be put in the following Public-Domain series:
  47.         Germany: Amiga Juice, Amok, Computer-Club-Niederrhein e.V. (CCN),
  48.                  Franz and GetiT.
  49.         USA:     Fred Fish
  50.  
  51.     You can pass on this program via modem.
  52.  
  53.  
  54.  
  55.   P r o h i b i t e d:
  56.     Any commercial use of the programs and also to put them together with
  57.     any other commercial products without my written permission.
  58.  
  59.     To put this program in   a n y   Series (Public-Domain or Non-Public-
  60.     Domain), e.g. in Germany: Taifun, Schatztruhe, KickStart etc.
  61.     This is of course with the exception of the series mentioned in
  62.     "Authorized".
  63.  
  64.     To remove my name from the program.
  65.  
  66.  
  67.   Wanted:
  68.     No money, but bug-reports.
  69.     If somebody updates it, please sent a copy.
  70.  
  71.  
  72.  
  73. How to start the program:
  74. =========================
  75.  
  76. from CLI:
  77.    RDT  [Directory]  [<OldToolname>  <NewToolname>]  Options
  78.  
  79. from Workbench:
  80.    Doubleclick the Icon and you will be asked from the program for
  81.    the necessary arguments.
  82.  
  83.  
  84. Arguments:
  85. ==========
  86.    Directory is the name of the directory, where you want to replace the
  87.      Default-Toolnames. Directory can be a Devicename too.
  88.      All further sub-directories will be scanned.
  89.      If you do not enter anything for the directory, the current directory
  90.      will be used.
  91.  
  92.    OldToolname is the old Default-Toolname.
  93.      If you enter "", all empty Default-Tools will set to the new Default-
  94.      Toolname.
  95.      If you enter * or #?, all Project-Icons will be set to the new Default-
  96.      Toolname. If you have not set the -i option (see below), you will be
  97.      asked if you are sure what you are doing. If you are sure, enter
  98.      y, Y, j or J. If you anything else, the program will be aborted.
  99.      * and #? can just be used by itself and not as joker within the file-
  100.      name. They have no meaning in a filename!
  101.  
  102.    NewToolname is the new Default-Toolname.
  103.      If you enter "", the old Default-Toolname will be erased and the
  104.      Default-Tool is now empty.
  105.  
  106.  
  107.    Options:
  108.    --------
  109.    -i  =  interactive
  110.           For each matching old Default-Toolname you will be asked, if
  111.           it should be replaced.
  112.  
  113.           On the input prompt you have the following possibilities:
  114.           ?             :  Helpline with the options.
  115.           q or Q        :  Aborts the program and replaces nothing.
  116.           y, Y, j or J  :  Sets a marking for replacing.
  117.           r or R        :  Abort further search and replace all marked
  118.                            files with the new Toolname.
  119.           anything else :  Old Toolname will not be replaced.
  120.  
  121.    -l  =  list
  122.           All filenames with a Project-Icon will be listed with the
  123.           corresponding Default-Toolname.
  124.  
  125.    -s  =  show
  126.           Every found Toolname will only be listed once.
  127.           Use this option, if you want to know, which Default-Toolnames
  128.           are available.
  129.           This option will not work in connection with the options -i and
  130.           -l. The program catches this automaticly.
  131.  
  132.    Note:
  133.           "" with the option list and show mean, that the Default-Tool in
  134.           the Project-Icon is not set.
  135.  
  136.           The options can be on any position in the startup-string. They
  137.           just have to start with a - and must be separated from other
  138.           arguments by a blank e.g.
  139.                 -i -l -s    and  n o t    -ils or -i-l-s.
  140.  
  141.  
  142. Samples:
  143. ========
  144.    RDT  DF0:  c:m2emacs c:DME
  145.       All Project-Icons in drive DF0: (including all directories and sub-
  146.       directories) with Default-Tool c:m2emacs will be replaced with c:DME.
  147.  
  148.    RDT  DH0:Tools  Utilities:More  c:MuchMore  -l
  149.       Within directory DH0:Tools and all further subdirectories the Default-
  150.       Tool Utilities:More will be replaced with c:MuchMore. The Default-Tools
  151.       of all found Project-Icons will be listed.
  152.  
  153.    RDT * :MM -i
  154.       The Default-Tools in the current directory and all subdirectories will
  155.       be set to :MM, after positivly answering the question.
  156.  
  157.  
  158. I m p o r t a n t   W a r n i n g !:
  159. ====================================
  160.    You should set the stack to a minimum of 20000, otherwise the program
  161.    may crash.
  162.    If you start the program from the CLI with a to small stack, you will
  163.    a stack overflow requester.
  164.    But, if you start from workbench and the stack is to small, you will
  165.    get an address error and after that a   G u r u  !  This seems to be
  166.    an error of my M2Amiga Modula-2 V3.3d compiler. If you know more about
  167.    this error, please let me know!
  168.  
  169.  
  170. Updates:
  171. ========
  172. I am not planning for any updates, with the exception of removing bugs.
  173.  
  174.  
  175. Credits:
  176. ========
  177.   Helmut Dalege    for the idea of this program.
  178.  
  179.   Jochen Kupfer    and
  180.   Peter Fischer    as beta testers and for their recommendations and
  181.                    suggestions.
  182.  
  183.   AMOK             All people of the Amiga Modula Club for their great work
  184.                    for the Amiga Modula-2 community.
  185.  
  186. Last but not least:
  187.   my wife          for tolerating my computer hobby.
  188.  
  189.